# eric7.Plugins.VcsPlugins.vcsGit.GitTagBranchListDialog

Module implementing a dialog to show a list of tags or branches.

### Global Attributes

None

### Classes

GitTagBranchListDialog | Class implementing a dialog to show a list of tags or branches.

### Functions

None

## GitTagBranchListDialog

Class implementing a dialog to show a list of tags or branches.

### Derived from

QDialog, Ui_GitTagBranchListDialog

### Class Attributes

None

### Class Methods

None

### Methods

GitTagBranchListDialog | Constructor
__finish | Private slot called when the process finished or the user pressed the button.
__generateItem | Private method to generate a tag item in the tag list.
__getCommit | Private method to get the commit id for a tag.
__procFinished | Private slot connected to the finished signal.
__processOutputLine | Private method to process the lines of output.
__readStderr | Private slot to handle the readyReadStderr signal.
__readStdout | Private slot to handle the readyReadStdout signal.
__resizeColumns | Private method to resize the list columns.
__resort | Private method to resort the tree.
__showError | Private slot to show some error.
closeEvent | Protected slot implementing a close event handler.
keyPressEvent | Protected slot to handle a key press event.
on_buttonBox_clicked | Private slot called by a button of the button box clicked.
on_input_returnPressed | Private slot to handle the press of the return key in the input field.
on_passwordCheckBox_toggled | Private slot to handle the password checkbox toggled.
on_sendButton_clicked | Private slot to send the input to the git process.
start | Public slot to start the tag/branch list command.

### Static Methods

None

#### GitTagBranchListDialog (Constructor)

GitTagBranchListDialog(vcs, parent=None)

Constructor

vcs (Git)
  reference to the vcs object
parent (QWidget)
  parent widget

#### GitTagBranchListDialog.__finish

__finish()

Private slot called when the process finished or the user pressed the button.

#### GitTagBranchListDialog.__generateItem

__generateItem(commit, name, msg="", bold=False, italic=False, underlined=False, tooltip="", )

Private method to generate a tag item in the tag list.

commit (str)
  commit id of the tag/branch
name (str)
  name of the tag/branch
msg (str (optional))
  tag annotation message (defaults to "")
bold (bool (optional))
  flag indicating to show the entry in bold (defaults to False)
italic (bool (optional))
  flag indicating to show the entry in italic (defaults to False)
underlined (bool (optional))
  flag indicating to show the entry underlined (defaults to False)
tooltip (str (optional))
  tooltip string to be shown for the item (defaults to "")

#### GitTagBranchListDialog.__getCommit

__getCommit(tag)

Private method to get the commit id for a tag.

tag (str)
  tag name

Return:
  commit id shortened to 10 characters

Return Type:
  str

#### GitTagBranchListDialog.__procFinished

__procFinished(_exitCode, _exitStatus)

Private slot connected to the finished signal.

_exitCode (int)
  exit code of the process (unused)
_exitStatus (QProcess.ExitStatus)
  exit status of the process (unused)

#### GitTagBranchListDialog.__processOutputLine

__processOutputLine(line)

Private method to process the lines of output.

line (str)
  output line to be processed

#### GitTagBranchListDialog.__readStderr

__readStderr()

Private slot to handle the readyReadStderr signal.

It reads the error output of the process and inserts it into the error pane.

#### GitTagBranchListDialog.__readStdout

__readStdout()

Private slot to handle the readyReadStdout signal.

It reads the output of the process, formats it and inserts it into the contents pane.

#### GitTagBranchListDialog.__resizeColumns

__resizeColumns()

Private method to resize the list columns.

#### GitTagBranchListDialog.__resort

__resort()

Private method to resort the tree.

#### GitTagBranchListDialog.__showError

__showError(out)

Private slot to show some error.

out (str)
  error to be shown

#### GitTagBranchListDialog.closeEvent

closeEvent(e)

Protected slot implementing a close event handler.

e (QCloseEvent)
  close event

#### GitTagBranchListDialog.keyPressEvent

keyPressEvent(evt)

Protected slot to handle a key press event.

evt (QKeyEvent)
  the key press event

#### GitTagBranchListDialog.on_buttonBox_clicked

on_buttonBox_clicked(button)

Private slot called by a button of the button box clicked.

button (QAbstractButton)
  button that was clicked

#### GitTagBranchListDialog.on_input_returnPressed

on_input_returnPressed()

Private slot to handle the press of the return key in the input field.

#### GitTagBranchListDialog.on_passwordCheckBox_toggled

on_passwordCheckBox_toggled(isOn)

Private slot to handle the password checkbox toggled.

isOn (bool)
  flag indicating the status of the check box

#### GitTagBranchListDialog.on_sendButton_clicked

on_sendButton_clicked()

Private slot to send the input to the git process.

#### GitTagBranchListDialog.start

start(path, tags, listAll=True, merged=True)

Public slot to start the tag/branch list command.

path (str)
  name of directory to be listed
tags (bool)
  flag indicating a list of tags is requested (False = branches, True = tags)
listAll (bool)
  flag indicating to show all tags or branches
merged (bool)
  flag indicating to show only merged or non-merged branches

Up